home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 3 / Info_Mac_1994-01.iso / Development / Source / Macintosh Tracker 1.1 Source / Original Tracker 3.10 Source / docs / readmefirst next >
Encoding:
Text File  |  1993-05-22  |  5.1 KB  |  110 lines  |  [TEXT/KAHL]

  1. Just a quick question-and-answer file.
  2.  
  3. - What is tracker, what do I need to use it ?
  4. tracker is a soundtracker player for unix machines. You need a sparcstation
  5. or an siligon graphics iris, or a PC with unix and soundblaster. Your machine
  6. should be able to produce sounds, that goes without saying. You also need
  7. tunes to play (mod files). Some are available on nic.funet.fi, for instance.
  8. You will also want to get zoo and lha for unix machines. They should be
  9. on nic.funet.fi or amiga.physik.unizh.ch.
  10.  
  11. - How to compile it ?
  12. Just make machine to build it all, and make install after you've decided
  13. where you want to put it. 
  14.  
  15. - How to use it ?
  16. tracker -help will give you a good idea of what's available.
  17.  
  18. - How does it compare with SparcTracker, or str32 ?
  19. Well it's better... No, actually it's the same program, but the name has
  20. changed as it was evolving.  So anything labelled SparcTracker100, 
  21. SparcTracker1.1, or sparctracker1.2 is OLD.  Don't send me any bug reports
  22. about these older versions, this is useless.  Well, I'll try not to change
  23. the name of the program again...
  24.  
  25. - What's new ?
  26. from 3.9:
  27. * linux: small bug-fix, 16 bit support
  28. * general: bug in finetune fixed
  29. from 3.7:
  30. * background/foreground csh-aware mode, much cleaner termio.
  31. from 3.6:
  32. * support for linux (thanks to Hannu Savolainen (hsavolai@cs.helsinki.fi)
  33. * small bug fix in termio: restore to a sane tty on exit.
  34. from 3.0 (never released):
  35. * more efficient replay routine, works faster, all glitches finally suppressed
  36. (I hope).
  37. * more options, better integrated.
  38. * much cleaner source code.
  39. from 2.17:
  40. * tracker is aware of the sparcstation 10.
  41. * bug fix for command 5 (portamento slide), that now works like
  42. portamento. Mostly affects apocalypse module.
  43. * support for most protracker extended commands, including finetune.
  44. * dynamic adjustements to the output frequency, fast skip, much better
  45. user-response overall.
  46. * better runtime interface (without those strange signals sequences)
  47. * better screen output
  48. * audio flush on the sparc, don't have to wait 10sec+ to exit.
  49.  
  50. - Which kind of modules can it play ?
  51. MOST soundtracker/noiseplayer/protracker modules should play out ok. Due
  52. to various disagreements between all the soundtracker versions (never forget
  53. soundtracker is an horrible HACK, a big KLUDGE), it is a *REAL* nightmare to
  54. try and make some commands work. What you have is my best effort at trying
  55. to outguess every soundtracker composer in existence... Obviously, I haven't
  56. completely succeeded. MED support I've thought of, but don't forget, to
  57. make tracker work, I need to reverse-engineer assembly routines coded like
  58. spaghetti, and transform it into more or less human-readable, normal C code.
  59. So up till now, I haven't had time enough to do the same with MED. Teijo's
  60. code is not exactly limpid, MEDplayer itself tends to change from release to
  61. release. So maybe one day...
  62. Here is what is missing from the protracker format
  63. * extended commands 3/4/7/13/14
  64.  
  65. Actually, if you know other player programs, you will notice that tracker is
  66. better at that compatibility game than most of them, like <BLIP>, <BLOP> or <ZP>
  67. (names intentionnally omitted:-) )
  68.  
  69.  
  70.  
  71. - What are these weird things scrolling on my screen ?
  72. These are some informations on the current module, like its name,
  73. the distinct sample lengths and their names. 
  74. Oh, you mean -show ? Well, this is the tune being played. Get any protracker
  75. doc, I think you'll understand what's going on.
  76.  
  77. - I can't change the volume of the sound.
  78. That's intentional. There are other programs that do that quite well.
  79. What you really want is an audio control panel. There are some nifty ones
  80. around, just search carefully. There is no need for tracker to support variable
  81. volume.
  82.  
  83. - There are some ``not supported'' messages from time to time.
  84. tracker doesn't support the whole set of protracker commands, so it tells
  85. you when it doesn't play something the way it's supposed to be played.
  86. I don't know if I'll implement the remaining commands, as they are symptomatic
  87. for me that the mod format is just a big kludge, and not getting any better...
  88.  
  89. - I want to use tracker on another machine.
  90. Then you'll have to port it. You can wedge in at two levels: either replace
  91. the audio.c file or the xxx_audio.c. The audio.c works at the amiga level:
  92. it interprets commands to play samples and repeat parts in terms of 
  93. resampling them at the right frequency. If your machine supports four fully
  94. independent channels (like the amiga), you shouldn't have to resample, but
  95. instead issue the proper commands for these samples to play.
  96. Else, you'll have to use resampling, and going through a specialized xxx_audio
  97. file. The examples you have should be quite enough.
  98. If you make tracker run on another machine, please send me the required changes.
  99. Try to keep it to either the audio.c or xxx_audio.c file. If you make any
  100. other enhancement, I might like to incorporate it in a further release, but
  101. that part of the code may have evolved beyond control in between. xxx_audio
  102. files I can grope !
  103.  
  104. - How do I know which version I have ?
  105. Look at the version strings embedded in the various source files, and into
  106. the program itself. The highest one is the winner (usually the one from 
  107. main.c).
  108.  
  109.     Marc Espie
  110.